<!DOCTYPE html>



  


<html class="theme-next muse use-motion" lang="zh-Hans">
<head><meta name="generator" content="Hexo 3.8.0">
  <meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
<meta name="theme-color" content="#222">









<meta http-equiv="Cache-Control" content="no-transform">
<meta http-equiv="Cache-Control" content="no-siteapp">
















  
  
  <link href="/lib/fancybox/source/jquery.fancybox.css?v=2.1.5" rel="stylesheet" type="text/css">







<link href="/lib/font-awesome/css/font-awesome.min.css?v=4.6.2" rel="stylesheet" type="text/css">

<link href="/css/main.css?v=5.1.4" rel="stylesheet" type="text/css">


  <link rel="apple-touch-icon" sizes="180x180" href="/images/apple-touch-icon-next.png?v=5.1.4">


  <link rel="icon" type="image/png" sizes="32x32" href="/images/favicon-32x32-next.png?v=5.1.4">


  <link rel="icon" type="image/png" sizes="16x16" href="/images/favicon-16x16-next.png?v=5.1.4">


  <link rel="mask-icon" href="/images/logo.svg?v=5.1.4" color="#222">





  <meta name="keywords" content="Spring Social,Spring Security,">










<meta name="description" content="在我们开发的应用中，通常会有第三方登录的需求（例如：QQ、微信、微博）。而第三方服务商开放的登录接口一般都是基于 OAuth 协议（国内一般基于 OAuth2 协议）。所以 Spring 官方为了开发便利，提供了 Spring Social  框架。 Spring Social 框架的目的就是将我们的系统连接社交网络。">
<meta name="keywords" content="Spring Social,Spring Security">
<meta property="og:type" content="article">
<meta property="og:title" content="Spring Social 介绍及原理">
<meta property="og:url" content="http://sangaizhi.gitee.io/2018/11/24/2018-11-24-spring-social-principle/index.html">
<meta property="og:site_name" content="sangaizhi-blog">
<meta property="og:description" content="在我们开发的应用中，通常会有第三方登录的需求（例如：QQ、微信、微博）。而第三方服务商开放的登录接口一般都是基于 OAuth 协议（国内一般基于 OAuth2 协议）。所以 Spring 官方为了开发便利，提供了 Spring Social  框架。 Spring Social 框架的目的就是将我们的系统连接社交网络。">
<meta property="og:locale" content="zh-Hans">
<meta property="og:image" content="http://sangaizhi.gitee.io/2018/11/24/2018-11-24-spring-social-principle/image1.png">
<meta property="og:image" content="http://sangaizhi.gitee.io/2018/11/24/2018-11-24-spring-social-principle/image2.png">
<meta property="og:updated_time" content="2018-12-11T13:18:36.059Z">
<meta name="twitter:card" content="summary">
<meta name="twitter:title" content="Spring Social 介绍及原理">
<meta name="twitter:description" content="在我们开发的应用中，通常会有第三方登录的需求（例如：QQ、微信、微博）。而第三方服务商开放的登录接口一般都是基于 OAuth 协议（国内一般基于 OAuth2 协议）。所以 Spring 官方为了开发便利，提供了 Spring Social  框架。 Spring Social 框架的目的就是将我们的系统连接社交网络。">
<meta name="twitter:image" content="http://sangaizhi.gitee.io/2018/11/24/2018-11-24-spring-social-principle/image1.png">



<script type="text/javascript" id="hexo.configurations">
  var NexT = window.NexT || {};
  var CONFIG = {
    root: '/',
    scheme: 'Muse',
    version: '5.1.4',
    sidebar: {"position":"left","display":"post","offset":12,"b2t":false,"scrollpercent":false,"onmobile":false},
    fancybox: true,
    tabs: true,
    motion: {"enable":true,"async":false,"transition":{"post_block":"fadeIn","post_header":"slideDownIn","post_body":"slideDownIn","coll_header":"slideLeftIn","sidebar":"slideUpIn"}},
    duoshuo: {
      userId: '0',
      author: '博主'
    },
    algolia: {
      applicationID: '',
      apiKey: '',
      indexName: '',
      hits: {"per_page":10},
      labels: {"input_placeholder":"Search for Posts","hits_empty":"We didn't find any results for the search: ${query}","hits_stats":"${hits} results found in ${time} ms"}
    }
  };
</script>



  <link rel="canonical" href="http://sangaizhi.gitee.io/2018/11/24/2018-11-24-spring-social-principle/">





  <title>Spring Social 介绍及原理 | sangaizhi-blog</title>
  








</head>

<body itemscope="" itemtype="http://schema.org/WebPage" lang="zh-Hans">

  
  
    
  

  <div class="container sidebar-position-left page-post-detail">
    <div class="headband"></div>

    <header id="header" class="header" itemscope="" itemtype="http://schema.org/WPHeader">
      <div class="header-inner"><div class="site-brand-wrapper">
  <div class="site-meta ">
    

    <div class="custom-logo-site-title">
      <a href="/" class="brand" rel="start">
        <span class="logo-line-before"><i></i></span>
        <span class="site-title">sangaizhi-blog</span>
        <span class="logo-line-after"><i></i></span>
      </a>
    </div>
      
        <p class="site-subtitle"></p>
      
  </div>

  <div class="site-nav-toggle">
    <button>
      <span class="btn-bar"></span>
      <span class="btn-bar"></span>
      <span class="btn-bar"></span>
    </button>
  </div>
</div>

<nav class="site-nav">
  

  
    <ul id="menu" class="menu">
      
        
        <li class="menu-item menu-item-home">
          <a href="/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-home"></i> <br>
            
            首页
          </a>
        </li>
      
        
        <li class="menu-item menu-item-categories">
          <a href="/categories/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-th"></i> <br>
            
            分类
          </a>
        </li>
      
        
        <li class="menu-item menu-item-archives">
          <a href="/archives/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-archive"></i> <br>
            
            归档
          </a>
        </li>
      
        
        <li class="menu-item menu-item-tags">
          <a href="/tags/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-tags"></i> <br>
            
            标签
          </a>
        </li>
      
        
        <li class="menu-item menu-item-about">
          <a href="/about/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-user"></i> <br>
            
            关于
          </a>
        </li>
      

      
    </ul>
  

  
</nav>



 </div>
    </header>

    <main id="main" class="main">
      <div class="main-inner">
        <div class="content-wrap">
          <div id="content" class="content">
            

  <div id="posts" class="posts-expand">
    

  

  
  
  

  <article class="post post-type-normal" itemscope="" itemtype="http://schema.org/Article">
  
  
  
  <div class="post-block">
    <link itemprop="mainEntityOfPage" href="http://sangaizhi.gitee.io/2018/11/24/2018-11-24-spring-social-principle/">

    <span hidden itemprop="author" itemscope="" itemtype="http://schema.org/Person">
      <meta itemprop="name" content="sangaizhi">
      <meta itemprop="description" content="">
      <meta itemprop="image" content="/images/avatar.gif">
    </span>

    <span hidden itemprop="publisher" itemscope="" itemtype="http://schema.org/Organization">
      <meta itemprop="name" content="sangaizhi-blog">
    </span>

    
      <header class="post-header">

        
        
          <h1 class="post-title" itemprop="name headline">Spring Social 介绍及原理</h1>
        

        <div class="post-meta">
          <span class="post-time">
            
              <span class="post-meta-item-icon">
                <i class="fa fa-calendar-o"></i>
              </span>
              
                <span class="post-meta-item-text">发表于</span>
              
              <time title="创建于" itemprop="dateCreated datePublished" datetime="2018-11-24T21:54:32+08:00">
                2018-11-24
              </time>
            

            

            
          </span>

          
            <span class="post-category">
            
              <span class="post-meta-divider">|</span>
            
              <span class="post-meta-item-icon">
                <i class="fa fa-folder-o"></i>
              </span>
              
                <span class="post-meta-item-text">分类于</span>
              
              
                <span itemprop="about" itemscope="" itemtype="http://schema.org/Thing">
                  <a href="/categories/spring-security/" itemprop="url" rel="index">
                    <span itemprop="name">spring security</span>
                  </a>
                </span>

                
                
              
            </span>
          

          
            
          

          
          

          

          

          

        </div>
      </header>
    

    
    
    
    <div class="post-body" itemprop="articleBody">

      
      

      
        <p>在我们开发的应用中，通常会有第三方登录的需求（例如：QQ、微信、微博）。而第三方服务商开放的登录接口一般都是基于 OAuth 协议（国内一般基于 OAuth2 协议）。所以 Spring 官方为了开发便利，提供了 Spring Social  框架。 Spring Social 框架的目的就是将我们的系统连接社交网络。<br><a id="more"></a></p>
<h3 id="一、Spring-Social-的基本原理"><a href="#一、Spring-Social-的基本原理" class="headerlink" title="一、Spring Social 的基本原理"></a>一、Spring Social 的基本原理</h3><h4 id="1、基本原理"><a href="#1、基本原理" class="headerlink" title="1、基本原理"></a>1、基本原理</h4><p>下面通过一张图的方式了解 Spring Social 的基本原理：<br><img src="/2018/11/24/2018-11-24-spring-social-principle/image1.png" alt="Spring Social的基本原理"><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;在上图的第8步中，根据用户构建了一个 Authentication 放进 SecurityContext里面就意味着用户使用第三方登录成功了。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;如果我们引导用户完成了上图的流程，实际上就表示用户使用第三方服务提供商完成了登录。这就是常见的第三方登录的基本原理和流程。</p>
<h4 id="2、Spring-Social-与-Spring-Security-的结合"><a href="#2、Spring-Social-与-Spring-Security-的结合" class="headerlink" title="2、Spring Social 与 Spring Security 的结合"></a>2、Spring Social 与 Spring Security 的结合</h4><p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;在完成整个流程的过程中，Spring Social 在其中有做了什么事情？实际上，Spring Social是把上面的整个步骤封装了起来，做成了过滤器(SocialAuthenticationFilter)并加入的 Spring Security 的过滤器链中(在UsernamePasswordAuthenticationFilter)之后。这样的话当我们在访问一个请求的时候，SocialAuthenticationFilter 拦截器就会把我们的这个请求拦截下来，然后引导我们走完上图的整个授权流程，从而实现第三方登录。这就是 Spring Social 做的最核心的事情。Spring Social 是如何把上面的流程封装到 Spring Security 所特有的接口和类中的呢？这些接口和类之间的依赖关系又是怎样的。<br>下面通过图的方式来说明这些接口和类。后续再详细说明<br><img src="/2018/11/24/2018-11-24-spring-social-principle/image2.png" alt="Spring Social的基本原理">       </p>
<h5 id="2-1、ServiceProvider-接口"><a href="#2-1、ServiceProvider-接口" class="headerlink" title="2.1、ServiceProvider 接口"></a>2.1、ServiceProvider 接口</h5><p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ServiceProvider 接口实际上是对服务提供商的抽象，每一个服务提供商都会提供一个自己的 ServiceProvider 的实现。当然， Spring Social 也为我们提供了一个默认实现：AbstractOAuth2ServiceProvider。这个抽象类中已经为我们实现了一些服务提供商共有的东西。</p>
<h5 id="2-2、OAuthOperations-接口"><a href="#2-2、OAuthOperations-接口" class="headerlink" title="2.2、OAuthOperations 接口"></a>2.2、OAuthOperations 接口</h5><p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;从 Spring Social的基本原理流程图上可以看出，第2步到第6步都是一个标准化的流程。对于这部分的流程，Spring Social 也为我们提供一个接口(OAuth2Operations)。在这个接口中，定义了关于 OAuth2 协议相关的操作。同样，该接口也有一个默认的抽象实现：OAuth2Template,OAuth2Template 这个类会帮助我们去完成 OAuth2 协议的执行的流程。所以在一般情况下，我们只需要继承该类，就可以操作 OAuth2 协议。</p>
<h5 id="2-3、-API-接口"><a href="#2-3、-API-接口" class="headerlink" title="2.3、 API 接口"></a>2.3、 API 接口</h5><p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;在Spring Social 的基本原理流程图上的第7步是获取用户信息，但是，针对不同的服务提供商，各自的用户信息也是有区别的，所有 API 是没有明确定义的。所以在这一步，Spring Social 并没有做过多的事情。所以这一步需要我们自己去写一个接口来封装获取用户信息的行为。当然，Spring Social 也为我们提供了一个 AbstractOAuth2APIBinding 抽象类,用来帮助我们快速实现 APIBinding 接口。</p>
<h5 id="2-4、Connection-接口"><a href="#2-4、Connection-接口" class="headerlink" title="2.4、Connection  接口"></a>2.4、Connection  接口</h5><p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Connection 接口是用来封装第7步获取到的用户信息，常用的是 OAuth2Connection。Connection 是由一个 ConnectionFactory 类创建的。一般我们常用的 ConnectionFactory 是 OAuth2ConnectionFactory。这个工厂负责创建 Connection 实例，也就是创建一个包含了用户信息的一个对象。为了创建这个对象，我们就需要拿到用户信息，而用户信息是通过完成完成第2到第7这几个步拿到的，所以为了完成这几个步骤，就需要一个 ServiceProvider 对象。当然在 ConnectionFactory 中实际上是包含一个 ServiceProvider 实例的。走到这里我们已经拿到了一个封装用户信息的 Connection 实例。但是这个 Connection 对象的数据结构是固定的，而服务提供商提供的数据接口确实不同。所以为了能把服务提供商的用户信息封装到 Connection 实例中，我们就需要一个中间类来完成这个步骤；所以 Spring Social 提供了了一个 APIAdapter 接口来帮助我们完成用户信息到 Connection 的适配。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;到此，我们已经清楚 Connection 封装的是服务提供商提供的用户信息。而在我们的实际业务系统中，我们一般也会用一张表来存储我们自己的用户信息。那么我们该怎么把服务提供商的用户信息与我们业务系统的用户信息进行关联呢？换句话说，就是怎么确定服务提供商的A用户登录代表我们业务系统的B用户登录呢？实际上，Spring Social 已经为我们考虑了这个问题。Spring Social 提供了一张关联表(表名是 UserConnection,具体的SQL文件在 spring-social-core-x.xx.jar 中的 org.springframework.social.connect.jdbc 包下)，这张关联表存储了我们业务系统用户的id和服务提供商用户信息的关联关系。既然有了表，那么我们就得有操作这张表的操作类；对此，Spring Social  中有一个 UsersConnectionRepository 接口，当然既然是操作数据库，我们就是使用它的实现类 JdbcUsersConnectionRepository。从这个类的名字可以看出，这是一个存储器，在这个类中，我们只需要提供一个 DataSource，它就可以帮助我们根据 Connection 实例来操作 UserConnection 表。</p>

      
    </div>
    
    
    

    

    

    

    <footer class="post-footer">
      
        <div class="post-tags">
          
            <a href="/tags/Spring-Social/" rel="tag"># Spring Social</a>
          
            <a href="/tags/Spring-Security/" rel="tag"># Spring Security</a>
          
        </div>
      

      
      
      

      
        <div class="post-nav">
          <div class="post-nav-next post-nav-item">
            
              <a href="/2018/11/20/2018-11-20-TreeMap/" rel="next" title="TreeMap">
                <i class="fa fa-chevron-left"></i> TreeMap
              </a>
            
          </div>

          <span class="post-nav-divider"></span>

          <div class="post-nav-prev post-nav-item">
            
              <a href="/2018/11/24/2018-11-24-oauth/" rel="prev" title="OAuth 协议">
                OAuth 协议 <i class="fa fa-chevron-right"></i>
              </a>
            
          </div>
        </div>
      

      
      
    </footer>
  </div>
  
  
  
  </article>



    <div class="post-spread">
      
    </div>
  </div>


          </div>
          


          

  



        </div>
        
          
  
  <div class="sidebar-toggle">
    <div class="sidebar-toggle-line-wrap">
      <span class="sidebar-toggle-line sidebar-toggle-line-first"></span>
      <span class="sidebar-toggle-line sidebar-toggle-line-middle"></span>
      <span class="sidebar-toggle-line sidebar-toggle-line-last"></span>
    </div>
  </div>

  <aside id="sidebar" class="sidebar">
    
    <div class="sidebar-inner">

      

      
        <ul class="sidebar-nav motion-element">
          <li class="sidebar-nav-toc sidebar-nav-active" data-target="post-toc-wrap">
            文章目录
          </li>
          <li class="sidebar-nav-overview" data-target="site-overview-wrap">
            站点概览
          </li>
        </ul>
      

      <section class="site-overview-wrap sidebar-panel">
        <div class="site-overview">
          <div class="site-author motion-element" itemprop="author" itemscope="" itemtype="http://schema.org/Person">
            
              <p class="site-author-name" itemprop="name">sangaizhi</p>
              <p class="site-description motion-element" itemprop="description"></p>
          </div>

          <nav class="site-state motion-element">

            
              <div class="site-state-item site-state-posts">
              
                <a href="/archives/">
              
                  <span class="site-state-item-count">18</span>
                  <span class="site-state-item-name">日志</span>
                </a>
              </div>
            

            
              
              
              <div class="site-state-item site-state-categories">
                <a href="/categories/index.html">
                  <span class="site-state-item-count">4</span>
                  <span class="site-state-item-name">分类</span>
                </a>
              </div>
            

            
              
              
              <div class="site-state-item site-state-tags">
                <a href="/tags/index.html">
                  <span class="site-state-item-count">17</span>
                  <span class="site-state-item-name">标签</span>
                </a>
              </div>
            

          </nav>

          

          

          
          

          
          

          

        </div>
      </section>

      
      <!--noindex-->
        <section class="post-toc-wrap motion-element sidebar-panel sidebar-panel-active">
          <div class="post-toc">

            
              
            
            
              <div class="post-toc-content">  <ol class="nav"><li class="nav-item nav-level-3"><a class="nav-link" href="#一、Spring-Social-的基本原理"><span class="nav-number">1.</span> <span class="nav-text">一、Spring Social 的基本原理</span></a><ol class="nav-child"><li class="nav-item nav-level-4"><a class="nav-link" href="#1、基本原理"><span class="nav-number">1.1.</span> <span class="nav-text">1、基本原理</span></a></li><li class="nav-item nav-level-4"><a class="nav-link" href="#2、Spring-Social-与-Spring-Security-的结合"><span class="nav-number">1.2.</span> <span class="nav-text">2、Spring Social 与 Spring Security 的结合</span></a><ol class="nav-child"><li class="nav-item nav-level-5"><a class="nav-link" href="#2-1、ServiceProvider-接口"><span class="nav-number">1.2.1.</span> <span class="nav-text">2.1、ServiceProvider 接口</span></a></li><li class="nav-item nav-level-5"><a class="nav-link" href="#2-2、OAuthOperations-接口"><span class="nav-number">1.2.2.</span> <span class="nav-text">2.2、OAuthOperations 接口</span></a></li><li class="nav-item nav-level-5"><a class="nav-link" href="#2-3、-API-接口"><span class="nav-number">1.2.3.</span> <span class="nav-text">2.3、 API 接口</span></a></li><li class="nav-item nav-level-5"><a class="nav-link" href="#2-4、Connection-接口"><span class="nav-number">1.2.4.</span> <span class="nav-text">2.4、Connection  接口</span></a></li></ol></li></ol></li></ol></div>
            

          </div>
        </section>
      <!--/noindex-->
      

      

    </div>
  </aside>


        
      </div>
    </main>

    <footer id="footer" class="footer">
      <div class="footer-inner">
        <div class="copyright">&copy; <span itemprop="copyrightYear">2018</span>
  <span class="with-love">
    <i class="fa fa-user"></i>
  </span>
  <span class="author" itemprop="copyrightHolder">sangaizhi</span>

  
</div>


  <div class="powered-by">由 <a class="theme-link" target="_blank" href="https://hexo.io">Hexo</a> 强力驱动</div>



  <span class="post-meta-divider">|</span>



  <div class="theme-info">主题 &mdash; <a class="theme-link" target="_blank" href="https://github.com/iissnan/hexo-theme-next">NexT.Muse</a> v5.1.4</div>




        







        
      </div>
    </footer>

    
      <div class="back-to-top">
        <i class="fa fa-arrow-up"></i>
        
      </div>
    

    

  </div>

  

<script type="text/javascript">
  if (Object.prototype.toString.call(window.Promise) !== '[object Function]') {
    window.Promise = null;
  }
</script>









  












  
  
    <script type="text/javascript" src="/lib/jquery/index.js?v=2.1.3"></script>
  

  
  
    <script type="text/javascript" src="/lib/fastclick/lib/fastclick.min.js?v=1.0.6"></script>
  

  
  
    <script type="text/javascript" src="/lib/jquery_lazyload/jquery.lazyload.js?v=1.9.7"></script>
  

  
  
    <script type="text/javascript" src="/lib/velocity/velocity.min.js?v=1.2.1"></script>
  

  
  
    <script type="text/javascript" src="/lib/velocity/velocity.ui.min.js?v=1.2.1"></script>
  

  
  
    <script type="text/javascript" src="/lib/fancybox/source/jquery.fancybox.pack.js?v=2.1.5"></script>
  


  


  <script type="text/javascript" src="/js/src/utils.js?v=5.1.4"></script>

  <script type="text/javascript" src="/js/src/motion.js?v=5.1.4"></script>



  
  

  
  <script type="text/javascript" src="/js/src/scrollspy.js?v=5.1.4"></script>
<script type="text/javascript" src="/js/src/post-details.js?v=5.1.4"></script>



  


  <script type="text/javascript" src="/js/src/bootstrap.js?v=5.1.4"></script>



  


  




	





  





  












  





  

  

  

  
  

  

  

  

</body>
</html>
